home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / spore / README < prev    next >
Text File  |  1995-05-03  |  2KB  |  67 lines
  1.  
  2.  
  3. Written by Ronald Joe Record (rr@sco.com) 07 Apr 1993
  4.  
  5. INTRO
  6. -----
  7.  
  8. The idea here is to calculate and display an aggregating particle.
  9. In order to accomplish this, a modified random walk algorithm is used.
  10. Initial spore(s) are randomly "seeded" in the center quarter of the screen.
  11. Subsequent "spores" randomly enter a rectangular neighborhood of a seed
  12. and "randomly walk" toward the seed. When within a pixel of a previously
  13. existing spore, the new spore "sticks". I called the program "spore" 
  14. because of the similar look to a mushroom spore print.
  15.  
  16. The colors in the image represent the "age" of spores. After N spores have
  17. been "stuck", the color index is incremented.
  18.  
  19. ACKNOWLEDGEMENTS
  20. ----------------
  21.  
  22. The algorithm was derived from lectures given by Dietmar Saupe at the 
  23. University of California at Santa Cruz. Assistance with colormaps and 
  24. spinning color wheels and X was gleaned from Hiram Clawson and Stacey Campbell.
  25.  
  26. BUILD
  27. -----
  28.  
  29. To build the spore binary, either use the Imakefile or the sample makefile,
  30. Makefile.std. If your system doesn't support prototypes, uncomment the 
  31. PROTODEFINE line of the Imakefile.
  32.  
  33. After modifying the Imakefile appropriately, either use "xmkmf" or "imake"
  34. to create a Makefile. Then just type "make" to compile spore.
  35.  
  36. The manual page can be formatted by typing "nroff -man spore.man > spore.6X".
  37.  
  38. INSTALL
  39. -------
  40.  
  41. To install spore, copy the spore binary to the desired location (the sample
  42. makefile puts it in /usr/local/bin)
  43. Copy the formatted man page to wherever you keep your local doc (i use
  44. /usr/man/cat.LOCAL for imaging software), then add that location
  45. to your MANPATH.
  46.  
  47. TEST
  48. ----
  49.  
  50. You can test spore by just invoking it with no arguments. It should display
  51. a 512x480 image. Some workstations may be slow to calculate and display a
  52. map as there are lots of calculations involved.
  53.  
  54. Some "interesting" ways to run spore are as follows :
  55. % spore -F -n 10 -d
  56. (use the full screen, calculate 10 maps in demo mode)
  57. % spore -R
  58. (display on the root window)
  59. % spore -o sporeprint.ppm
  60. (calculate and display with default parameters and save the resulting image
  61.  as a PPM file called sporeprint.ppm. this can be viewed later using xv or 
  62.  any PPM viewing utility)
  63.  
  64. Ideas, comments, additions, deletions, suggestions, bug reports, code review,...
  65. e-mail Ronald Record at rr@sco.com or ...uunet!sco!rr.
  66.  
  67.